Video wallpapers from geo-restricted websites fail to load without proxy support, resulting in black screens. This adds configurable proxy settings (HTTP/HTTPS/SOCKS5) with optional authentication.

Implementation

Core Settings (Sucrose.Memory, Sucrose.Manager)

• Added 6 proxy constants: ProxyEnabled, ProxyType, ProxyServer, ProxyPort, ProxyUsername, ProxyPassword
• Created ProxyType enum: None, HTTP, HTTPS, SOCKS5
• Added validated getters to Engine manager

Engine Integration

• MPV Player: Injects http-proxy=scheme://[user:pass@]host:port into mpv.conf on startup
• CefSharp: Adds --proxy-server=scheme://host:port to CefSettings command-line args
• WebView2: Adds --proxy-server="scheme://host:port" to AdditionalBrowserArguments

UI (Sucrose.Portal)

• Added Network section to Other Settings with expandable proxy configuration card
• Fields: enable toggle, type dropdown, server/port inputs, optional username/password
• All changes persist to Engine settings JSON

Localization

• Added English strings for Network area, proxy settings, and ProxyType enum values

Example

// MPV Player generates config on startup
if (SMME.ProxyEnabled && !string.IsNullOrEmpty(SMME.ProxyServer) && SMME.ProxyPort > 0)
{
    string protocol = SMME.ProxyType switch {
        SSDEPT.SOCKS5 => "socks5",
        SSDEPT.HTTPS => "https",
        _ => "http"
    };
    Content += $"http-proxy={protocol}://{auth}{SMME.ProxyServer}:{SMME.ProxyPort}";
}

Notes

• Proxy authentication in CefSharp/WebView2 requires IRequestHandler implementation for full support (username/password fields prepared for future enhancement)
• Local media engines (Nebula, Xavier, Vexana, Aurora) unaffected - no network access needed
• Settings require wallpaper restart to take effect

Files changed: 10 files, 375 additions, 1 deletion

• Fixes Could you add a proxy usage function in the settings options? #157

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.